Unzip v1.1 (Archive: Funzip.zip)
================================

This is a freeware user-friendly front end for the unzip.img image 
file from David Palmer. The umzip.img file can be found on 
CompuServe in the Palmtop forum library 18 in different versions 
(see the Installation section below)

I wrote this application as I could never remember the command line 
options I needed to unzip files. As David had kindly added full OPL 
launch support in version 1.41 of his unzip.img, I managed to knock 
up Unzip.opa in OPL in a couple of hours.

Unzip can be used as a replacement for, or a supplement to David 
Palmer's run.app. Unzip is also a bit smaller than run.app. Compare 
the file sizes...

        File       Size  Time     Date 
      unzip.opa    2023  01:10  07-May-96
      run.app      2208  01:10  25-Nov-95


What's New in This Version
==========================
In Unzip v1.1 I have added support for the older versions (v1.0,
v1.2 and v1.3) of the unzip.img files, as a lot of people still use
these older versions because v1.41 removed support for archives
zipped with PKZIP v1.1.


Archive Contents
================
When you unzipped this file you should have found:

        File       Size  Time     Date 
      unzip.opa    2023  01:10  07-May-96 (application)
      unzip.txt    8131  01:10  07-May-96 (this text file)


Installation
============
1. Make sure you have the unzip.img file.
   Unzip.img is part of the complete unzip package from
   David Palmer, which is available as...

      Archive       Version  Size   Time     Date 
     s3uzip14.zip    v1.41   32960  01:41  25-Nov-95
     s3uzip2.zip     v1.3    33760  11:35  18-Apr-94
     unzip.img       v1.2    43376  ??:??  21-Jun-94
     s3uzip.zip      v1.0    44144  23:24  03-Apr-93

   ...in the Palmtop forum's library 18 on CompuServe.
   (Version/Size/Date/Time are for the unzip.img image file)
   You can also get unzip.img by anonymous ftp from 
   ftp://sunsite.doc.ic.ac.uk/computing/systems/handhelds
   /psion/icdoc/utils/s3uzip14.zip

2. Copy unzip.opa into the *same* directory as unzip.img
   This is important: Unzip.opa will not work unless it is in the
   same directory and same drive as unzip.img.

3. Install the Unzip.opa application from the system screen by using
   Psion-I, pressing Tab, and navigating to the directory where 
   Unzip is located.

   Note: all you need to unzip is unzip.img and unzip.opa. All other
   files in David Palmer's archive can be deleted from the Psion if
   you need to save precious memory space.
   

Operation
=========
Unzip contains a simple dialog for selecting the most useful unzip 
options. Not all options are included, as I believe not all are 
needed. If anyone needs any more, please contact me and I'll build 
them in.
When you start Unzip (the same way as you would start any other 
application) you will see a dialog that will look like this...


         Unzip v1.1 using Unzip.img vX.XX   [Esc] to exit

 Unzip from:   Name         <file>          <- file to unzip
               Disk        Internal
 Unzip to dir:   Name      UNZIP\           <- it will unzip to this dir
                 Disk      Internal
 Options:                  Extract archives <- choose an option...
 Modifiers:                None             <- ...and a modifier...
 Overwrite existing files: Prompt           <- ...and confirm overwrite


The X.XX will show the version number of the unzip.img file that is
present on your Psion 3a.
Note that if you have a unzip.img version less than v1.40, then
the "Unzip to dir:" option cannot be selected and all files will
be unzipped to the root directory on your default disk.

Press [Esc] from the dialog to exit Unzip.


Unzip's Dialog
==============
Unzip from
----------
Unzip looks for files with a .ZIP extension in the \CIS\LIBRARY 
directory on the internal disk. I chose this as I normally want to 
unzip files I download from CIS. If the \CIS\LIBRARY directory does 
not exist, then Unzip will try and show \CIS or otherwise just the 
root directory. You can press [Tab] to bring up the file selector
to select any file you wish.


Unzip to dir
------------
For unzip.img files of v1.40 or greater, Unzip will unzip to \UNZIP 
on the internal disk as default. If you have no \UNZIP, then it 
will unzip to the root directory. Press [Tab] for the file selector.
For unzip.img files earlier than v1.40, Unzip will unzip to the 
root directory on your default disk.



Options
-------
Extract archives (default) 
	This will extract all the files in the zipped archive.

List archives (short form)
	This lists all the files in the zipped archive showing size 
	and date.

List archives (long form)
	This does the same as the short form list but displays a bit 
	more information about each file.

Display archive comment
	Does just that.

Test archive integrity
	Test to see if the archived files are not corrupted and if 
	they can be unzipped OK by Unzip.

Freshen existing & create none
	This will unzip files only if the zipped files have a 
	timestamp which is newer than the existing files. 
	The existing file is overwritten. No new files are created. 
	This is the best choice if you wish to update an existing 
	program but you do *not* want to unzip files you have 
	previously deleted. A good choice when unzipping directly
	to a flash SSD.
	NOTE: Unzip.img complains if you choose "Freshen existing
	& create none" with the overwrite option "Never" at the same 
	time.

Update existing & create new
	This will unzip files only if the zipped files have a 
	timestamp which is newer than the existing files, and it will
	also create any new files if they do not exist.
	This is a good choice if you want to unzip all archive files 
	(including new files) direct to a flash SSD - existing files 
	that have *not* changed will *not* be replaced, thus saving 
	precious flash SSD space.


Modifiers
---------
None
	No modifiers.

Throw away paths
	If the archive contains paths, normally they are extracted 
	and created when unzipping.
	Choosing this option will *prevent* the paths from being 
	created, and all files will be unzipped to the same directory.

Quiet operation
	Prevents most text from being displayed on the screen.

Very quiet operation
	Even quieter than quiet operation.


Overwrite existing files
------------------------
Prompt
	Unzip will ask you what to do if it finds an existing file.

Never
	Unzip will *never* overwrite any existing files.
	NOTE: Unzip.img complains if you choose "Never" and "Freshen
	existing & create none" at the same time.

Always
	Unzip will *always* overwrite existing files.



Illegal Combinations
====================
Unzip.img will complain if you select a combination of 
"Options: Freshen existing & create none" AND "Overwrite existing 
files: Never" 


Unzip.img Compatibility
=======================
I have tested Unzip.opa with versions 1.0, 1.2, 1.3 and 1.41 of 
Unzip.img, and these all work happily.
Unzip.opa will automatically detect which version of unzip.img you 
have and allow/disallow options accordingly.
If Unzip.opa fails to detect the version of unzip.img, then it will
display version 0.00 in the dialog and disallow selection of the 
"Unzip to dir:" option. The unzipping should however still work OK,
and the files will be unzipped to the root directory of the default
drive.


Acknowledgements
================
Full acknowledgements go to David Palmer of Edinburgh, Scotland, for 
his wonderful unzip.img and his excellent documentation.


Change History
==============
7-May-96 v1.1	Added support for unzip.img v1.0/1.2/1.3.
		Renamed a couple of options and fixed a spelling
		mistake.
		Optimized code to make the .opa as small as 
		possible.
1-May-96 v1.0	Original version (only for unzip.img v1.41)


-------------------
Jochen Siegenthaler
Zurich, Switzerland
07 May, 1996
100127.3167@compuserve.com

